home *** CD-ROM | disk | FTP | other *** search
/ Programming Languages Suite / ProgramD2.iso / Database / Foxpro 2.06 Distribution Kit / DKREADME.TXT next >
Text File  |  1994-03-14  |  15KB  |  442 lines
  1.                        DKREADME.TXT
  2. **********************************************************
  3.  Microsoft(R) FoxPro(R) Version 2.6 Professional Edition
  4.  
  5.                Distribution Kit for MS-DOS(R)
  6.  
  7.    (C)1994 Microsoft Corporation. All Rights Reserved.
  8. **********************************************************
  9.  
  10. =========
  11. CONTENTS
  12. =========
  13.  
  14. Part   Description
  15. ----   -----------
  16.  1      Installation
  17.  2      Knowledge Base Articles
  18.  3      Changes to Distribution Kit User's Guide Since 
  19.         Printing
  20.  4      Answers to Commonly Asked Questions
  21.  5      Error Messages
  22. ----------------------------------------------------------
  23.  
  24. =====================
  25. Part 1: Installation
  26. =====================
  27.  
  28. Installing the Professional Edition of FoxPro 2.6
  29. -------------------------------------------------
  30. The Professional Edition of FoxPro 2.6 includes the
  31. following kits:
  32.  
  33. Distribution Kit
  34. Connectivity Kit
  35. Library Construction Kit
  36. WorkGroup Extensions (FoxPro for Windows only) 
  37.  
  38. To install the Professional Edition of FoxPro, first install
  39. the main FoxPro product, then follow the installation 
  40. instructions included with each individual kit.  The order 
  41. in which the kits are installed does not matter.
  42. ----------------------------------------------------------
  43.  
  44. FoxPro version 2.6 now includes the FoxPro Wizards, located
  45. in the WIZARDS subdirectory. The FoxPro Wizards and 
  46. CATALOG.APP should not be distributed with your applications.
  47. ----------------------------------------------------------
  48.  
  49. ================================
  50. Part 2: Knowledge Base Articles
  51. ================================
  52.  
  53. If you installed the Knowledge Base articles, you can view 
  54. them by running the application KBVIEW.APP.  These articles 
  55. contain useful information about a variety of FoxPro topics.
  56. ----------------------------------------------------------
  57.  
  58. =================================================
  59. Part 3: Changes to Distribution Kit User's Guide 
  60.         Since Printing
  61. =================================================
  62.  
  63. In the Distribution Kit User's Guide, references to FoxPro
  64. 2.5 should be read as references to FoxPro 2.6.
  65. ----------------------------------------------------------
  66.  
  67. Chapter 1, page 2:  The first bulleted item should read:
  68.  
  69. "The Distribution Kit files, in both 5.25-inch and
  70. 3.5-inch disk formats."
  71. ----------------------------------------------------------
  72.  
  73. Chapter 2, page 10, under "Available Runtime Menus and Menu
  74. Options," the File menu item should read:
  75.  
  76. File menu: Close, Save, Save As and Revert
  77. ----------------------------------------------------------
  78.  
  79. Chapter 2, page 11, under "Features Not Available in
  80. Distributed Applications," add the following section below
  81. the "Menus" section:
  82.  
  83. Menu Pads
  84.  
  85. The following FoxPro menu pads aren't available in the
  86. applications you distribute.
  87.  
  88. SYSTEM Menu:  Macros..., Filer
  89.   FILE Menu:  New..., Open..., Printer setup...,
  90.               Print..., Quit
  91. WINDOW Menu:  Color..., Command, Debug, Trace, View
  92. ----------------------------------------------------------
  93.  
  94. The files with extensions .ESL or .ESO have been renamed for
  95. the new version.  For example:
  96.  
  97. FOXPRO.ESL is now FOXD2600.ESL
  98. FOXPRO.ESO is now FOXD2600.ESO
  99. FOXPROX.ESL is now FOXDX260.ESL
  100.  
  101. The new file names impact the following pages in the
  102. Distribution Kit User's Guide:
  103.  
  104. Chapter 1, page 5, the Distribution Kit Files table.
  105.  
  106. Chapter 3, page 22, change the last sentence to read:
  107.  
  108. "The .EXE Support Library consists of three files:
  109. FOXD2600.ESL, the standard .EXE Support Library
  110. FOXD2600.ESO, and the 32-bit Extended .EXE Support
  111. Library FOXDX260.ESL."
  112.  
  113. Chapter 5, page 32, the table called Files Required on
  114. Distribution Disks Based on Type of Application has
  115. these changes: 
  116.  
  117. In the "You must also distribute these files" column,
  118. substitute the .ESL and .ESO file names with the new
  119. File names.
  120. ----------------------------------------------------------
  121.  
  122. Chapter 2, page 15, under the heading "Help in a Project"
  123. add the following information:
  124.  
  125. "If your help files are included in your project but
  126. marked as excluded, you must distribute the .DBF and .FPT
  127. files with your application. These files can be changed by
  128. the user. If you don't want your users to have the ability
  129. to change the contents of your help files, include them in
  130. your project, but don't mark them as excluded."
  131. ----------------------------------------------------------
  132.  
  133. Chapter 5, page 33, the Files Your Application May
  134. Require table should include DRIVER2.PLB as a file your
  135. application may require.  This file contains printer 
  136. drivers.  You must distribute this file if your
  137. application requires printer drivers.
  138. ----------------------------------------------------------
  139.  
  140. ============================================
  141. Part 4: Answers to Commonly Asked Questions
  142. ============================================
  143.  
  144. Question 1
  145.  
  146. What type of applications (single-user, multi-user) can
  147. be built with the Distribution Kit?
  148.  
  149. Answer 1
  150.  
  151. You can build single-user or multi-user applications 
  152. with the Distribution Kit.  
  153. ----------------------------------------------------------
  154.  
  155. Question 3
  156.  
  157. Suppose I write a program for Client A and compile the 
  158. program as a compact .EXE file and give the 
  159. application to Client A, together with the *.ES? Library 
  160. files with which to run the application.  Client A owns 
  161. the application and the copyright.  Client A then sells 
  162. the application to many other people.
  163.  
  164. Question 3.1
  165.  
  166. Does Client A also have to purchase the Distribution Kit?
  167.  
  168. Answer 3.1
  169.  
  170. No, Client A does not need to purchase the Distribution
  171. Kit. Only the developer who uses the Distribution Kit to
  172. build the original .EXE file must own a licensed copy of
  173. the Distribution Kit.
  174.  
  175. Question 3.2 
  176.  
  177. Does Client A have to purchase the FoxPro 2.6 development
  178. system?
  179.  
  180. Answer 3.2
  181.  
  182. Client A does not have to purchase FoxPro 2.6 because
  183. the client is not building their own .EXE; Client A is
  184. just reseller.  Client A must distribute the application
  185. in its original form, however, and cannot remove the
  186. runtime files to include the application with another
  187. application.
  188.  
  189. Question 3.3 
  190.  
  191. Does the above also apply to stand-alone .EXE files?
  192.  
  193. Answer 3.3
  194.  
  195. Yes.
  196. ----------------------------------------------------------
  197.  
  198. Question 4
  199.  
  200. Why is Build Executable dimmed after I install the Distribution
  201. Kit?
  202.  
  203. Answer 4
  204.  
  205. Two possible reasons: First, the Distribution Kit must
  206. be installed in your FoxPro directory. Ensure that the
  207. FoxPro files are not marked as read-only before installing
  208. the Distribution Kit. Second, the project does not include
  209. a SET MAIN program. Select the main menu or program, then
  210. choose Main from the Project menu.
  211. ----------------------------------------------------------
  212.  
  213. Question 5
  214.  
  215. When I compile an .EXE file, the process stops with a
  216. "Cannot Open File" error message that refers to a
  217. Distribution Kit program file.  When I grant all access
  218. rights (except for delete) to the program directory, the
  219. program compiles.  However, the compilation process
  220. leaves several files in the program directory with names
  221. like WLK02112.--A, WLK02112.--B, WLK02112.--C, and so on.
  222. What are these files?
  223.  
  224. Answer 5
  225.  
  226. Compiling program files in the FoxPro Distribution Kit
  227. places temporary files in the directory from which you
  228. start FoxPro. The TMPFILES statement in the CONFIG.FP
  229. file does not affect file placement.
  230.  
  231. Include the full path to the network drive and directory
  232. where the FoxPro development and distribution programs
  233. are installed. Start FoxPro from a user directory
  234. that has all rights, including erase or delete rights,
  235. assigned to it.  The process of compiling using the
  236. Distribution Kit creates files in and deletes files from
  237. the user directory. The system administrator can designate
  238. the program directory read only.
  239. ----------------------------------------------------------
  240.  
  241. Question 6
  242.  
  243. I have created an application that does not allow me to
  244. edit my table/.DBF files. How can I correct this problem?
  245.  
  246. Answer 6
  247.  
  248. Mark your table/.DBF as excluded in the project, then
  249. rebuild your application. You must distribute these files
  250. to your end users. Including the table/.DBF in the project
  251. automatically makes these files read only.
  252. ----------------------------------------------------------
  253.  
  254. Question 8
  255.  
  256. How do you instruct an MS-DOS .FXP, .APP or compact .EXE
  257. file to run in extended mode from within Windows?
  258.  
  259. Answer 8
  260.  
  261. An .FXP, .APP or .EXE file will run in standard mode when
  262. run from within Windows, even though there is enough
  263. memory for the extended mode Support Library to run.  To
  264. force use of the Extended Support Library from within 
  265. Windows, you can use the +X loader switch to launch your
  266. application.
  267. ----------------------------------------------------------
  268.  
  269. =======================
  270. Part 5: Error Messages
  271. =======================
  272.  
  273. Message: "Feature Not Available"
  274.  
  275. Question 1
  276.  
  277. My executable file runs correctly in the development
  278. version of FoxPro, but I receive the error message
  279. "Feature Not Available" when running the stand-alone
  280. application. How can I correct this problem?
  281.  
  282. Answer 1.1
  283.  
  284. You will get the "Feature not available" error message
  285. when you use commands, features, and menus that require
  286. the development version of FoxPro.  Refer to the "Features
  287. Not Available in Distributed Applications"  list in the 
  288. FoxPro Distribution Kit User's Guide for a list of these
  289. commands and functions.  These commands and functions
  290. include: BUILD APP, BUILD EXE, BUILD PROJECT, COMPILE,
  291. FILER, CREATE/MODIFY MENU, CREATE/MODIFY QUERY,
  292. CREATE/MODIFY SCREEN, SET VIEW ON, and SUSPEND and
  293. features specific to the interactive development
  294. environment such as the Trace, Debug, Command, and
  295. View windows.
  296.  
  297. Answer 1.2
  298.  
  299. You will get the "Feature not available" error message
  300. when using commands containing macro substitution in
  301. a stand-alone .EXE file. When you compile a stand-alone
  302. .EXE file, the compiler includes only the code necessary
  303. to run the commands explicitly included in the
  304. application.  If there is macro substitution anywhere
  305. in a line of code, that entire line is skipped, since
  306. FoxPro does not explicitly "see" the command referenced
  307. by the macro-substituted variable. The result is that
  308. the code to execute the substituted command is not built
  309. into the .EXE file.
  310.  
  311. The following examples illustrate two methods for
  312. ensuring that macro-substituted commands are included
  313. in your compiled .EXE file:
  314.  
  315. Example 1
  316.  
  317. As a developer you might want to allow the user to
  318. choose either reports or labels by storing the choice
  319. "report" or "label" in a memory variable called
  320. m.output. You could then store the file name in the
  321. memory variable m.filename.  You would include the
  322. following command to run the report or labels in your
  323. application:
  324.  
  325. &output FORM &filename TO PRINT NOCONSOLE
  326.  
  327. The Distribution Kit compiler will successfully create
  328. a stand-alone .EXE file with this code. However, when
  329. FoxPro attempts to execute the command, you will get a
  330. "Feature Not Available" runtime error because the code
  331. for the REPORT FORM and the LABEL FORM commands is not
  332. included in the .EXE file. To avoid this problem,
  333. include the following If statement at the beginning of
  334. your application:
  335.  
  336.   IF .F.
  337.     REPORT FORM dummy
  338.     LABEL FORM dummy
  339.   ENDIF
  340.  
  341. The file names do not have to exist.  The IF .F.
  342. guarantees the code will never be executed. You are
  343. simply making these commands visible to the compiler.
  344.  
  345. Example 2
  346.  
  347. This code example illustrates the use of macro
  348. substitution for the PACK command. Because the code
  349. does not explicitly issue the PACK command, FoxPro does
  350. not include the required code in the stand-alone .EXE
  351. file. An attempt to run the PACK command from the macro
  352. substitution fails.
  353.  
  354. testcom="pack"
  355. &testcom
  356.  
  357. To address this situation, create another procedure,
  358. such as the following, and include it in the project.
  359.  
  360. procedure addon
  361. pack
  362. return
  363. ----------------------------------------------------------
  364.  
  365. Message: "Dynamic memory exhausted"
  366.  
  367. Question 1
  368.  
  369. What is the cause and solution for a "Dynamic memory
  370. exhausted" error message when compiling a stand-alone
  371. .EXE file?
  372.  
  373. Answer 1
  374.  
  375. This error message is sent by the WATCOM linker, which
  376. is one of the tools in the FoxPro Distribution Kit used
  377. to create a stand-alone application.  The message is
  378. displayed when the amount of available conventional
  379. memory is too low.  The WATCOM linker (WLINK8.EXE) uses
  380. only conventional memory.
  381.  
  382. If the CONFIG.FP file contains the DOSMEM=ON statement,
  383. edit the file to remove the statement. If the CONFIG.FP
  384. file does not contain a DOSMEM statement, edit the
  385. AUTOEXEC.BAT and CONFIG.SYS files to remove unnecessary
  386. device drivers and memory-resident applications to
  387. maximize available conventional memory.
  388. ----------------------------------------------------------
  389.  
  390. Message: "Link command failed"
  391.  
  392. Question 1
  393.  
  394. When I attempt to build an executable file, I receive the
  395. error message "Link command failed."  How can I correct
  396. this problem?
  397.  
  398. Answer 1
  399.  
  400. If you receive this error message, check the following
  401. items:
  402.  
  403. a. Make sure that enough conventional memory is available.
  404.    Modify the CONFIG.SYS and AUTOEXEC.BAT files to free
  405.    conventional memory.
  406.  
  407. b. Make sure that enough disk space is available.
  408.  
  409. c. Increase the number of file handles available to
  410.    Microsoft FoxPro for MS-DOS.  To do this, you can
  411.    modify the FILES statement in the CONFIG.SYS file to
  412.    increase the number of available files. In the Novell
  413.    NetWare environment, modify the FILE HANDLES
  414.    statement in the SHELL.CFG file to increase the number
  415.    of available files.
  416.  
  417. d. If the AUTOEXEC.BAT file loads the SHARE utility,
  418.    increase the values specified by the /F and /L 
  419.    parameters. For example:
  420.  
  421.    SHARE /F:5120 /L:500
  422.  
  423. e. Make sure that FoxPro can find your COMMAND.COM file.
  424.    Modify the SHELL statement in the CONFIG.SYS file to
  425.    specify the /P (permanent) option switch.  Be sure
  426.    SHELL= or COMSPEC= is set for the proper path to
  427.    COMMAND.COM.
  428.  
  429. f. Make sure that the following files are in a directory
  430.    listed in the MS-DOS PATH environment variable in the
  431.    AUTOEXEC.BAT file:
  432.  
  433.    WLINK8.EXE and FOXSWAP.COM.
  434.  
  435. g. If you are running the Extended Version of FoxPro,
  436.    remove the DOSMEM=ON statement (if it is present) from
  437.    the CONFIG.FP file.
  438. ----------------------------------------------------------
  439.                     ===================
  440.                     END OF DKREADME.TXT
  441.                     ===================
  442.